Category Icon   Built-in Command-line Tools

Apple Remote Desktop (ARD) includes two powerful command-line tools which can be used with Send UNIX Command: networksetup and systemsetup. The tools themselves are embedded within the ARD client software, and will not interfere with existing installations of the software on Mac OS X Server. The tools' location is added to the default shell PATH, so you can access it through Remote Desktop as if it were installed in one of the standard UNIX tool locations. To change any settings using these tools, you must run them with root permissions (su root, or sudo).

networksetup

The command-line tool networksetup is used to configure a client's network settings. It can create or modify network locations, change IP addresses, set network service proxies, and much more. You will find the command-line syntax, explanations, and an example in the tool's help prompt, by entering the following as one line in Terminal:

/System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Support/networksetup -help

systemsetup

The command-line tool systemsetup is used to configure other non-network system settings. It can query or alter time zones, network time servers, sleep settings, Energy Saver preferences, Remote Login (ssh) preferences, and more. You will find the command-line syntax, explanations, and example in the tool's help prompt, by entering the following as one line in the Terminal:

/System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Support/systemsetup -help